home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / inn-1.4 / README < prev   
Encoding:
Text File  |  1993-12-02  |  4.2 KB  |  92 lines
  1. $Revision: 1.28 $
  2.  
  3. InterNetNews -- the Internet meets Netnews
  4. ------------------------------------------
  5. "Remember to tell your kids about the days when USENET was store and
  6.  forward."  -- Jim Thompson, as part of a message that said he was getting
  7.  under 200ms propagation, disk to disk.
  8.  
  9. InterNetNews is a complete Usenet system.  The cornerstone of the package
  10. is innd, an NNTP server that multiplexes all I/O.  Think of it as an nntpd
  11. merged with the B News inews, or as a C News relaynews that reads multiple
  12. NNTP streams.  Newsreading is handled by a separate server, nnrpd, that is
  13. spawned for each client.  Both innd and nnrpd have some slight variances
  14. from the NNTP protocol; see the manpages.
  15.  
  16. The distribution is a compressed tar file.  Create a directory, cd into it,
  17. and unpack the tar file in that directory.  For example:
  18.     ; mkdir inn
  19.     ; cd inn
  20.     ; ftp ftp.uu.net
  21.     ftp> user anonymous <you@your.host.name>
  22.     ftp> type image
  23.     ftp> get news/nntp/inn/inn.tar.Z inn.tar.Z
  24.     ftp> quit
  25.     ; uncompress <inn.tar.Z | tar vxf -
  26.     ; rm inn.tar.Z
  27.  
  28. The installation instructions are in Install.ms.  This is an nroff/troff
  29. document that uses the -ms macro package, and is about 30 typeset pages.
  30. The distribution has this file split into two pieces; you can join them
  31. by typing either of the following commmands:
  32.     ; make Install.ms
  33.     ; cat Install.ms.? >Install.ms
  34. You should probably print out a copy of config/config.dist when you print
  35. out the installation manual.
  36.  
  37. Please read the COPYRIGHT.  This package has NO WARRANTY; use at your
  38. own risk.
  39.  
  40. When updating from a previous release, you will usually want to do "make
  41. update" from the top-level directory; this will only install the programs.
  42. To update your scripts and config files, cd into the "site" directory and
  43. do "make clean" -- this will remove any files that are unchanged from
  44. the official release.  Then do "make diff >diff"; this will show you what
  45. changes you will have to merge in.  Now merge in your changes (from
  46. where the files are, ie. /usr/lib/news...) into the files in
  47. $INN/site.  (You may find that due to the bug fixes and new features in
  48. this release, you may not need to change any of the scripts, just the
  49. configuration files).  Finally, doing "make install" will install
  50. everything.
  51.  
  52. If you have a previous release you will probably also want to update the
  53. pathnames, etc., in the new config file from your old config.  Here is one
  54. way to do that:
  55.     % cd config
  56.     % make subst
  57.     % cp config.dist config.data
  58.     % ./subst -f {OLDFILE} config.data
  59. where "{OLDFILE}" names your old config.data file.
  60.  
  61. Configuration is done using subst.   Subst is in config/subst.sh and
  62. doc/subst.1.  The history file is written using DBZ.  The DBZ sources and
  63. manual page are in the dbz directory.  Unlike subst, DBZ is kept
  64. separately, to make it easier to track the C News release.  The subst
  65. script and DBZ data utilities are currently at the "Performance Release"
  66. patch date.  Thanks to Henry Spencer and Geoff Collyer for permission to
  67. use and redistribute subst, and to Jon Zeef for permission to use DBZ as
  68. modified by Henry.
  69.  
  70. This version includes support for Geoff Collyer's news overview package,
  71. known as nov.  Nov replaces the external databases used by nn, trn, etc.,
  72. with a common text database.  INN support includes programs to build and
  73. maintain the overview database, and an XOVER command added to nnrpd (the
  74. news-reading daemon) that is becoming a common extension to fetch the
  75. overview data from an NNTP connection.  Nnrpd uses the overview database
  76. internally, if it exists, making certain commands (e.g., XHDR) much
  77. faster.  The nov package includes a newsreader library that you will need,
  78. and some utilities that you will not; it is available on world.std.com in
  79. the file src/news/nov.dist.tar.Z.  Prototypes of modified newsreaders are
  80. in the in src/news/READER.dist.tar.Z -- most maintainers will be providing
  81. official support very soon.  To make it explicit:  if you already have a
  82. newsreader that can use the overview database, either via my NNTP xover
  83. command, or by reading directly from NFS, then INN has all you need.
  84.  
  85. I hope you find INN useful.  If you like it, send me a postcard.
  86.     Rich $alz
  87.     Open Software Foundation
  88.     11 Cambridge Center
  89.     Cambridge, MA  02142
  90.     INN mail:    <rsalz@uunet.uu.net>
  91.     Other mail:    <rsalz@osf.org>
  92.